package cn.iocoder.yudao.module.pickbook.dal.mysql.checkin;

import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
import cn.iocoder.yudao.module.pickbook.dal.dataobject.checkin.PickbookCheckinDO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.util.List;

/**
 * 打卡记录 Mapper
 *
 * @author 芋道源码
 */
@Mapper
public interface PickbookCheckinMapper extends BaseMapperX<PickbookCheckinDO> {

    /**
     * 根据用户ID和日期查询打卡记录
     *
     * @param userId 用户ID
     * @param date 日期
     * @return 打卡记录
     */
    PickbookCheckinDO selectByUserIdAndDate(@Param("userId") Long userId, @Param("date") LocalDate date);

    /**
     * 根据用户ID查询打卡记录总数
     *
     * @param userId 用户ID
     * @return 总数
     */
    Long selectCountByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID分页查询打卡记录列表
     *
     * @param userId 用户ID
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 打卡记录列表
     */
    List<PickbookCheckinDO> selectListByUserId(@Param("userId") Long userId, 
                                              @Param("offset") Integer offset, 
                                              @Param("limit") Integer limit);

    /**
     * 根据班级ID查询打卡记录总数
     *
     * @param classId 班级ID
     * @return 总数
     */
    Long selectCountByClassId(@Param("classId") Long classId);

    /**
     * 根据班级ID分页查询打卡记录列表
     *
     * @param classId 班级ID
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 打卡记录列表
     */
    List<PickbookCheckinDO> selectListByClassId(@Param("classId") Long classId, 
                                               @Param("offset") Integer offset, 
                                               @Param("limit") Integer limit);

    /**
     * 根据用户ID查询总打卡天数
     *
     * @param userId 用户ID
     * @return 总打卡天数
     */
    Integer selectTotalDaysByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID查询总阅读绘本数
     *
     * @param userId 用户ID
     * @return 总阅读绘本数
     */
    Integer selectTotalBooksByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID查询今日阅读绘本数
     *
     * @param userId 用户ID
     * @return 今日阅读绘本数
     */
    Integer selectTodayBooksByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID查询本周阅读绘本数
     *
     * @param userId 用户ID
     * @return 本周阅读绘本数
     */
    Integer selectWeekBooksByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID查询本月阅读绘本数
     *
     * @param userId 用户ID
     * @return 本月阅读绘本数
     */
    Integer selectMonthBooksByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID和日期范围查询打卡日期列表
     *
     * @param userId 用户ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 打卡日期列表
     */
    List<LocalDate> selectCheckinDatesByUserIdAndDateRange(@Param("userId") Long userId,
                                                          @Param("startDate") LocalDate startDate,
                                                          @Param("endDate") LocalDate endDate);

} 